package cn.com.jonpad.demowebflux.ctrl;

import org.springframework.http.codec.ServerSentEvent;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Flux;
import reactor.util.function.Tuples;

import java.time.Duration;
import java.util.concurrent.ThreadLocalRandom;

/**
 * <h1>服务器推送事件</h1>
 * 服务器推送事件（Server-Sent Events，SSE）允许服务器端不断地推送数据到客户端。
 * 相对于 WebSocket 而言，服务器推送事件只支持服务器端到客户端的单向数据传递。
 * 虽然功能较弱，但优势在于 SSE 在已有的 HTTP 协议上使用简单易懂的文本格式来表示传输的数据。
 * 作为 W3C 的推荐规范，SSE 在浏览器端的支持也比较广泛，除了 IE 之外的其他浏览器都提供了支持。
 * 在 IE 上也可以使用 polyfill 库来提供支持。
 * 在服务器端来说，SSE 是一个不断产生新数据的流，非常适合于用反应式流来表示。
 * 在 WebFlux 中创建 SSE 的服务器端是非常简单的。
 * 只需要返回的对象的类型是 Flux<ServerSentEvent>，就会被自动按照 SSE 规范要求的格式来发送响应。
 * @author Jon Chan
 * @date 2019/1/18 14:30
 */
@RestController
@RequestMapping("sse")
public class SseController {
    @GetMapping("randomNumbers")
    public Flux<ServerSentEvent<Integer>> randomNumbers() {
        return Flux.interval(Duration.ofSeconds(1))
                .map(seq -> Tuples.of(seq, ThreadLocalRandom.current().nextInt()))
                .map(data -> ServerSentEvent.<Integer>builder()
                        .event("random")
                        .id(Long.toString(data.getT1()))
                        .data(data.getT2())
                        .build());
    }
}
